home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / ftn / tapeio.z / tapeio
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  74 lines
  1. TAPEIO(3F)                                            Last changed: 3-12-99
  2.  
  3.  
  4. NNAAMMEE
  5.      ttooppeenn, ttcclloossee, ttrreeaadd, ttwwrriittee, ttrreewwiinn, ttsskkiippff, ttssttaattee - FORTRAN tape
  6.      device-specific I/O routines
  7.  
  8. SSYYNNOOPPSSIISS
  9.      iinntteeggeerr  ttooppeenn,, ttcclloossee,, ttrreeaadd,, ttwwrriittee,, ttrreewwiinn,, ttsskkiippff,, ttssttaattee
  10.      iinntteeggeerr  _t_l_u
  11.      cchhaarraacctteerr**((**)) _b_u_f_f_e_r
  12.      cchhaarraacctteerr**((**)) _d_e_v_n_a_m
  13.      llooggiiccaall _l_a_b_l_e_d
  14.  
  15.      _i_e_r_r_o_r == ttooppeenn((_t_l_u,, _d_e_v_n_a_m,, _l_a_b_l_e_d))
  16.      _i_e_r_r_o_r == ttcclloossee((_t_l_u))
  17.      _n_b_y_t_e_s == ttrreeaadd((_t_l_u,, _b_u_f_f_e_r))
  18.      _n_b_y_t_e_s == ttwwrriittee((_t_l_u,, _b_u_f_f_e_r))
  19.      _i_e_r_r_o_r == ttrreewwiinn ((_t_l_u))
  20.      _i_e_r_r_o_r == ttsskkiippff ((_t_l_u,, _n_f_i_l_e_s,, _n_r_e_c_s))
  21.  
  22.      iinntteeggeerr _f_i_l_e_n_o,, _r_e_c_n_o,, _e_r_r,, _e_o_f,, _e_o_t,, _t_c_s_r
  23.      _i_e_r_r_o_r == ttssttaattee ((_t_l_u,, _f_i_l_e_n_o,, _r_e_c_n_o,, _e_r_r,, _e_o_f,, _e_o_t,, _t_c_s_r))
  24.  
  25. IIMMPPLLEEMMEENNTTAATTIIOONN
  26.      IRIX systems
  27.  
  28.      MIPSpro Fortran 77
  29.  
  30. DDEESSCCRRIIPPTTIIOONN
  31.      ttaappeeiioo is the general name for the set of intrinsic I/O functions that
  32.      operate on a tape device.  ttooppeenn, ttcclloossee, ttrreewwiinn, ttsskkiippff, and ttssttaattee
  33.      return --11 on error, 00 if successful. ttrreeaadd and ttwwrriittee return --11 on
  34.      error, the number of bytes read (or written) on success.
  35.  
  36.      ttooppeenn opens a tape unit for I/O.  _d_e_v_n_a_m is the name of the tape
  37.      device.  _l_a_b_l_e_d should be ..ttrruuee.. if the tape is labeled.  _t_l_u is set
  38.      to the logical unit number of the tape device used for subsequent
  39.      calls.
  40.  
  41.      ttcclloossee closes a tape unit previously opened by ttooppeenn.
  42.  
  43.      ttrreeaadd reads from the tape device into _b_u_f_f_e_r.  _n_b_y_t_e_s is set to the
  44.      number of bytes actually read, or --11 for an error.  Zero (0) may be
  45.      returned in an end-of-file or end-of-tape situation.
  46.  
  47.      ttwwrriittee writes to the tape device from _b_u_f_f_e_r.  _n_b_y_t_e_s is set to the
  48.      number of bytes actually written, or --11 for an error.
  49.  
  50.      ttrreewwiinn rewinds the tape device.
  51.  
  52.      ttsskkiippff skips forward _n_f_i_l_e_s files and _n_r_e_c_s records.
  53.  
  54.      ttssttaattee returns the status of the tape channel.  Upon successful
  55.      completion, 0 is returned and the following values are set:
  56.  
  57.      _f_i_l_e_n_o    current file number
  58.  
  59.      _r_e_c_n_o     current record number
  60.  
  61.      _e_r_r       1 if there are errors, 0 if there are no errors
  62.  
  63.      _e_o_f       1 if it is at end-of-file, 0 if not
  64.  
  65.      _e_o_t       1 if it is at end-of-tape, 0 if not
  66.  
  67.      _t_c_s_r      the value of the drive status register; see mmtt__ddssrreegg in
  68.                //uussrr//iinncclluuddee//ssyyss//mmttiioo..hh.
  69.  
  70. SSEEEE AALLSSOO
  71.      mmttiioo(7)
  72.  
  73.      This man page is available only online.
  74.